home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / padc.z / padc
Text File  |  1998-10-20  |  11KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPAAAADDDDCCCC((((1111))))                                                                PPPPAAAADDDDCCCC((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_aaaa_dddd_cccc - process activity data collector
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _pppp_aaaa_dddd_cccc _----_ssss_rrrr_kkkk [_----_IIII _l_e_n] [_----_hhhh _p_r_i] [_----_bbbb _b_u_f_s_z] [_----_tttt _t_i_m_e]
  13.  
  14.      _pppp_aaaa_dddd_cccc _----_ssss_rrrr_kkkk [_----_iiii] [_----_IIII _l_e_n] [_----_hhhh _p_r_i] [_----_bbbb _b_u_f_s_z] [_----_tttt _t_i_m_e]
  15.                [_----_pppp _p_i_d]
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _pppp_aaaa_dddd_cccc traces the activity of a process or group of processes and writes
  19.      the raw event data to the standard output.  System calls, scheduling
  20.      actions, and disk i/o operations are activities that _pppp_aaaa_dddd_cccc can trace.  In
  21.      addition to kernel-generated events, _pppp_aaaa_dddd_cccc collects any events created by
  22.      processes through the _rrrr_tttt_mmmm_oooo_nnnn______llll_oooo_gggg______uuuu_ssss_eeee_rrrr______tttt_ssss_tttt_aaaa_mmmm_pppp(3) library routine.
  23.  
  24.      _pppp_aaaa_dddd_cccc is normally invoked by the _pppp_aaaa_rrrr(1) program which reads and formats
  25.      its output.  _pppp_aaaa_dddd_cccc can also be invoked by itself with the event data
  26.      written to a file for later processing by _pppp_aaaa_rrrr or _rrrr_tttt_mmmm_oooo_nnnn_----_dddd_uuuu_mmmm_pppp(1).
  27.  
  28.      By default, _pppp_aaaa_dddd_cccc traces the requested events for all processes on a
  29.      system.  System call event collection can be restricted to a specific set
  30.      of processes with one or more ----pppp options.  If the ----iiii option is given, all
  31.      future children of the specified processes will also have their system
  32.      calls traced.  If the ----tttt option is specified, _pppp_aaaa_dddd_cccc will collect trace
  33.      data for a limited amount of time.
  34.  
  35.      _pppp_aaaa_dddd_cccc collects trace data until: the time specified with the ----tttt option has
  36.      elapsed, _pppp_aaaa_dddd_cccc receives a SSSSIIIIGGGGIIIINNNNTTTT or a SSSSIIIIGGGGHHHHUUUUPPPP signal, or all processes to
  37.      be traced have terminated.
  38.  
  39.      The execution of traced processes is not affected when _pppp_aaaa_dddd_cccc is collecting
  40.      event data.
  41.  
  42. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  43.      ----bbbb _b_u_f_s_z  Use a buffer _b_u_f_s_z bytes large to buffer event data written to
  44.                the standard output.  By default _pppp_aaaa_dddd_cccc buffers up to 128
  45.                Kilobyte of data before writing the data to the standard
  46.                output.  Setting _b_u_f_s_z to zero causes _pppp_aaaa_dddd_cccc to buffer its output
  47.                as little as possible.
  48.  
  49.      ----hhhh _p_r_i    Run _pppp_aaaa_dddd_cccc with a nondegrading realtime scheduling priority _p_r_i.
  50.                By default _p_a_d_c tries to use the same realtime scheduling
  51.                priority that the system event collection process uses.  This
  52.                will only happen if _p_a_d_c is started by the super-user.  _p_a_d_c
  53.                tries to match scheduling priority so that it can compete
  54.                equally for CPU time when doing system-wide event collection.
  55.  
  56.      ----kkkk        Trace all disk i/o operations on the system.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPAAAADDDDCCCC((((1111))))                                                                PPPPAAAADDDDCCCC((((1111))))
  71.  
  72.  
  73.  
  74.      ----IIII _m_a_x    Set the maximum amount of data returned by the kernel for
  75.                indirect parameter values returned with a system call event.
  76.                Some system calls (e.g. _rrrr_eeee_aaaa_dddd) have potentially lots of data
  77.                associated with them.  _pppp_aaaa_dddd_cccc always collects direct system call
  78.                arguments; this option can be used to control the amount of
  79.                indirect data.  If _m_a_x is 0, then no indirect parameter values
  80.                will be collected.  Otherwise _m_a_x can be any value up to a
  81.                maximum determined by the operating system; by default 4096
  82.                bytes.  Note that setting this value to a large number
  83.                increases the probability of losing events.
  84.  
  85.      ----iiii        Inherit system call tracing to future children of the processes
  86.                specified with ----pppp options.
  87.  
  88.      ----pppp _p_i_d    Enable system call event tracing for the specified _p_i_d.  This
  89.                option may be specified multiple times to enable system call
  90.                tracing for multiple processes.  Processes specified with this
  91.                option must belong to the current user unless the user has
  92.                super-user privilege.
  93.  
  94.      ----rrrr        Trace scheduling events for all processes on the system.
  95.  
  96.      ----ssss        Trace system calls for processes specified with the ----pppp and ----iiii
  97.                options.
  98.  
  99.      ----tttt _t_i_m_e   Collect data for a _t_i_m_e-second interval.
  100.  
  101. NNNNOOOOTTTTEEEESSSS
  102.      _pppp_aaaa_dddd_cccc reads its information from the _rrrr_tttt_mmmm_oooo_nnnn_dddd(1) server process on the
  103.      machine where the traced processes are located.  The _rrrr_tttt_mmmm_oooo_nnnn_----_cccc_llll_iiii_eeee_nnnn_tttt(1)
  104.      program may be used to collect trace data from an _rrrr_tttt_mmmm_oooo_nnnn_dddd process on a
  105.      different machine; the only restriction is that you cannot (easily)
  106.      collect system call event data.
  107.  
  108.      _pppp_aaaa_dddd_cccc's main task is to merge multiple streams of event data that are
  109.      collected on multi-processor systems.  This work may require a
  110.      significant amount of memory if the system is heavily loaded because much
  111.      event data may need to be buffered to insure events are properly sorted
  112.      by time.  For this reason _pppp_aaaa_dddd_cccc does not merge event data when doing
  113.      system-wide event collection; instead _pppp_aaaa_rrrr recognizes that it needs to
  114.      sort-merge the event data when displaying event traces (since it
  115.      typically is run after the event data has been collected).
  116.  
  117.      Event data collected by _pppp_aaaa_dddd_cccc is time stamped with a high resolution
  118.      timer.  The resolution of this timer depends on the system hardware; this
  119.      value is recorded in the event stream so that post-processing programs
  120.      such as _pppp_aaaa_rrrr can properly calculate time values.
  121.  
  122.      To reduce system load, system call events generated by _pppp_aaaa_dddd_cccc itself are
  123.      not recorded.  This can lead to some inexplicable gaps in the schedule
  124.      trace.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPAAAADDDDCCCC((((1111))))                                                                PPPPAAAADDDDCCCC((((1111))))
  137.  
  138.  
  139.  
  140. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  141.      _U_n_a_b_l_e _t_o _c_o_n_t_a_c_t _r_t_m_o_n _s_e_r_v_i_c_e _o_n _l_o_c_a_l _h_o_s_t.  There is no _rrrr_tttt_mmmm_oooo_nnnn_dddd server
  142.      process running on the system.  Usually this is because the rtmond
  143.      service has been disabled; consult _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg(1M).
  144.  
  145.      _C_a_n_n_o_t _r_e_a_c_h _r_t_m_o_n _s_e_r_v_i_c_e _o_n _l_o_c_a_l _h_o_s_t, _a_c_c_e_s_s _d_e_n_i_e_d.  The _rrrr_tttt_mmmm_oooo_nnnn_dddd
  146.      server process has been configured to deny access to all users on the
  147.      local host.
  148.  
  149.      _U_n_a_b_l_e _t_o _s_t_a_r_t _d_a_t_a _c_o_l_l_e_c_t_i_o_n; _s_e_r_v_e_r _d_i_s_a_l_l_o_w_e_d _e_v_e_n_t _c_o_l_l_e_c_t_i_o_n.  The
  150.      _rrrr_tttt_mmmm_oooo_nnnn_dddd server process has been configured to restrict the set of events
  151.      that may be collected and you have requested collection of events that
  152.      are unavailable.
  153.  
  154.      _U_n_a_b_l_e _t_o _s_t_a_r_t _d_a_t_a _c_o_l_l_e_c_t_i_o_n; _t_e_m_p_o_r_a_r_i_l_y _o_u_t _o_f _r_e_s_o_u_r_c_e_s.  The
  155.      _rrrr_tttt_mmmm_oooo_nnnn_dddd server process was unable to start event collection because it ran
  156.      out of system resources such as threads or memory.
  157.  
  158. FFFFIIIILLLLEEEESSSS
  159.      _////_dddd_eeee_vvvv_////_pppp_aaaa_rrrr               for enabling system call tracing
  160.      _////_tttt_mmmm_pppp_////_...._rrrr_tttt_mmmm_oooo_nnnn_dddd______ssss_oooo_cccc_kkkk_eeee_tttt    UNIX domain socket for client connections
  161.  
  162. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  163.      _pppp_aaaa_rrrr(1), _rrrr_tttt_mmmm_oooo_nnnn_----_cccc_llll_iiii_eeee_nnnn_tttt(1), _rrrr_tttt_mmmm_oooo_nnnn_----_dddd_uuuu_mmmm_pppp(1), _rrrr_tttt_mmmm_oooo_nnnn_dddd(1), _pppp_aaaa_rrrr(7).
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.